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Airtime for Broadcasters 



Airtime is the open broadcast software for scheduling and remote station management. Web 
browser access to the station's media, multi-file upload and automatic metadata verification 
features are coupled with a collaborative on-line scheduling calendar and playlist management. The 
scheduling calendar is managed through an easy-to-use interface and triggers playout with sub- 
second precision. 
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Airtime has been intended to provide a solution for a wide range of broadcast projects, from 
community to public and commercial stations. The scalability of Airtime allows implementation in a 
number of scenarios, ranging from an unmanned broadcast unit accessed remotely through the 
Internet, to a local network of machines accessing a central Airtime storage system. Airtime 
supports the playout of files in both the commonly used MP3 format and the open, royalty-free 
equivalent Ogg Vorbis. 

Airtime manages the Liquidsoap stream generator, which is at the heart of the system. Liquidsoap 
accesses the Airtime media archive, stored in a PostgreSQL database. Editors and station controllers 
can use Airtime to build playlists and manage files (upload, add metadata, manage advertisements) 
inside the station or via the Internet, using a standard web browser such as Mozilla Firefox or 
Internet Explorer. 

The scheduler in Airtime has a calendar view, organized by months, weeks and days. Here the 
program editors can schedule playlists and streams for their broadcast station. In some scenarios, 
the transmitter is situated outside the reach of the broadcaster and all program management has to 
be maintained through the web interface. Possible reasons for this scenario might be of a pragmatic 
nature (running many stations from one central office due to limited human resources) or an 
emergency (running a transmitter in a crisis area without putting staff at risk). 

Example system 

Combining Airtime, the Liquidsoap stream generator and PostgreSQL storage, you can supply a 
broadcast station with all the functionality needed for automation. 



In the diagram below, the media files are stored on a separate PostgreSQL machine accessible 
through the local network. Liquidsoap outputs streams to both the transmitter and a streaming 
media server. The machine running Airtime is behind a firewall because it is connected both to the 
local network, and to the Internet for remote access. This enables Airtime to offer password- 
protected access to the media database and scheduling from both inside and outside the studio 
building. 
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Manual installation 



The following instructions assume that you have root access (sudo on Ubuntu) to a GNU/Linux 
server, and are familiar with basic command line tasks. 

The recommended Airtime server platform is Ubuntu 10.04 'Lucid Lynx' LTS. The server should have 
at least a 1GHz processor and 512MB of RAM. The Airtime installation does not use much disk space, 
but you should allow plenty of storage capacity for the media archive. A hot-swap RAID array is 
recommended for the media archive, in case of disk failure. You should also consider a U PS or other 
battery powered system to offer some protection against short-term power failures. 

If you intend that your Airtime server will have a direct audio output to a broadcast transmitter or a 
separate stream encoder, your server machine must have a soundcard supported by an ALSA driver. 
Almost all standard soundcards have ALSA drivers built into the Linux kernel, which do not need to 
be installed separately. If in doubt about driver support, check the ALSA soundcard matrix at: 
http://www.alsa-project.0rg/main/index.php/Matrix:Main 

If your Airtime machine will only be used to stream to an Icecast streaming media server, you do 
not require a soundcard to be installed on the server side. This option is suitable for Airtime 
installations at your ISP's datacenter, remote from any transmitter. 

The Airtime web administration interface is intended to work with any browser, on any desktop or 
mobile platform. The recommended web browser is Mozilla Firefox 3.6. 

Install dependencies 

A few of the packages that Airtime relies on are in the U buntu "universe" or "multiverse" repositories. 
If either of these repositories is disabled, you can enable them in the /etc/apt/sources.list file, by 
opening the nano editor in your server's console with the command: 

$ sudo nano /etc/apt/sources.list 

Find the lines which begin deb and end with lucid universe or lucid-updates universe, adding multiverse 
to the end of these lines if it is not there already. 



t deb cdron: [Ubuntu 10.04 LTS Jjucid Lynx_ - Release and64 (20100429)]/ lucid nain restricted 
t See httpt//help.ubwta.coii/coiiiiunity/UpgradeNotes for hou to upgrade to 
i newer versions of the distribution. 

deb http://gb.archive. ubuntu. con/ubuntu/ lucid Bain 

tt Hajor bug fix updates produced after the final release of the 

t* distribution. 

deb http://gb.archive. ubuntu. con/ubuntu/ lucid-updates Main 

tt H.B. software fron this repository is ENTIRELY UNSUPPORTED by the Ubuntu 

t* tea*. Also, please note that software in universe HILL NOT receive any 

tt review or updates fron the Ubuntu security tean. 

deb http://gb.archive.ubuntu.con/ubunitu/ lucid universe nultiverse| 

deb httpIZ/gb.archive. ubuntu. con/ubuntu/ lucid-updates universe nultiverse 

tt H.B. software fron this repository is ENTIRELY UNSUPPORTED by the Ubuntu 
tt tean, and nay not be under a free licence. Please satisfy yourself as to 
tt your rights to use the software. Also, please note that software in 
tt nultiverse HILL NOT receive any review or updates fron the Ubuntu 
tt security tean. 
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The exact repository mirror URLs in your sources.list file will differ from the above screenshot, 
depending on your location. Press Ctrl+O (the Ctrl key and the letter O together) to save the file, 
then Ctrl+X to exit the nano editor. Then reload the package list with: 



$ sudo apt-get update 

This command fetches lists of the latest package from the repositories that you have configured for 
your server. 
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Next, install the list of dependencies for Airtime. For example, on Ubuntu 10.04 (Lucid Lynx) LTS you 
can enter the command: 

$ sudo apt-get install apache2 daemontools daemontools-run icecast2 lame \ libao-ocaml 
libapache2-mod-php5 libcamomile-ocaml-dev libesd0 \ libmad-ocaml libportaudio2 
libsamplerate0 libsoundtouch-ocaml \ libtaglib-ocaml multitail odbc-postgresql 
oggvideotools openssl php-pear \ php5-gd php5-pgsql poc-streamer postgresql pwgen 
python python-conf igobj \ python-mutagen unzip 

The final dependency to install is phing (note that you must use the version number shown): 

$ sudo pear channel-discover pear. phing. info 
$ sudo pear install phing/phing-2.4.2 

Remove PulseAudio 

The PulseAudio sound server is not compatible with Airtime. To remove it from an Ubuntu machine, 
type the following command: 

$ sudo apt-get purge pulseaudio 

Removing the pulseaudio package on a desktop Ubuntu machine may force the removal of the 
ubuntu-desktop metapackage. However, this metapackage is only on the system for managing 
upgrades; removing it does not remove the GNOME desktop. 

After removing PulseAudio, if your Airtime machine has a desktop and a soundcard,you can install a 
mixer applet which can control the ALSA soundcard driver directly, such as gnome-alsamixer. 

$ sudo apt-get install gnome-alsamixer 

On a server with a soundcard but without a desktop, you can control sound output levels using the 
command line program alsamixer. This package should already be installed on an Ubuntu machine 
with a soundcard. 
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Configure PHP 

Edit the php.ini file to change PHP settings for the server to those that Airtime requires. 
$ sudo nano /etc/php5/apache2/php. ini 



GNU nano 2.2.2 File: /etc/php5/apache2/php.ini 1 


[PHP] 




J About php.ini J 




; PHP's initialization file, generally called php.ini, is responsible for 




J configuring many of the aspects of PHP's behavior. 




; PHP attempts to find and load this configuration from a number of locations. 




; The following is a summary of its search order: 




J 1. SAPI module specific location. 




; 2, The PHPRC environment variable, (As of PHP 5,2.0) 




; 3. A number of predefined registry keys on Windows (As of PHP 5.2.0) 




; 4. Current working directory (except CLI) 




J 5. The web server's directory (for SAPI modules), or directory of PHP 




; (otherwise in Windows) 




; 6. The directory from the — with-config-file-path compile time option, or the 




; Windows directory (C:\windows or C:\winnt) 




! See the PHP docs for more specific information. 
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This is a long file, so use the search tool (press Ctrl+W) to find the particular lines that you're 
looking for. The recommended initial settings for Airtime are: 

memory_limit = 256M 

request_order = "GPC" 

post_max_size = 150M 

upload_max_f ilesize = 150M 

upload_tmp_dir = /tmp 

session. gc_probability = 

If any of the above lines are commented out with a semi-colon at the beginning, you will need to 
remove that semi-colon for the setting to work. 

You also need to set the timezone that the server is in. Find the line which begins date.timezone, 
remove the semi-colon comment if present, and add your timezone to the end of the line. For 
example: 



date.timezone 



"America/Toronto" 



You can find the correct timezone value for your location at 
http://www.php.net/manual/en/timezones.php 

Press Ctrl+O to save the file, then Ctrl+X to exit the nano editor. 



Download Airtime 

The latest version of the Airtime installer is available at: 



http://www.sourcefabric.org/en/products/airtime_download/ 

For example, to download version 1.6.1 from SourceForge in the server console you could enter the 
command: 

$ wget http: //sourceforge. net/pro jects/airtime/files/airtime-1. 6. 1-GA. tar.gz 





ne/f i 1 es/a i rt i me-1 . G . 
ne-l,6.1-GA.tar,gz 


Resolving sour-cefor-ge.net... 216.34.18! 


1.60 




Connecting to sourcef orge.net 1216.34. 131. 60 1 :S0... connected. 




HTTP request sent, awaiting r-esponse... 


. 302 Found 




Locat i on : http://sourcef orge . net/pro jet 


i:ts/airtime/files/airtirne-1.6.1-GA.tar 


.gz/download [folloui 


ng] 






—2011-03-01 13:27:14- http://source) 
wnload 


Forge.net/projects/airtime/files/airtii 


ne-1.6.1-GA.tar.gz/do 


Reusing existing connection to sourceft 


nrge.net:80. 




HTTP request sent, awaiting r-esponse... 


, 302 Found 




Locat i on : http://doun 1 oads . sourcef or-ge . 


. net/pro ject/air-ti me/a irtirne-1. 6. 1-GA.i 


.TBIig3g%*SE:i:K[i;ii»I 


37i»use_rnirror=switch [following] 
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*n— &LS— ±nJd3oOvOt i>USe_rHlr POP— SWILCn 

Resolving downloads.sour-cefor-ge.net... 


216.34.181.58 




Connecting to down loads. sourcef orge.nel 


t 1216. 34. 131. 59 1:30... connected. 




HTTP request sent, awaiting response... 


. 302 Found 




Location: http://switch.dl. sourceforge. 


. net/pro ject/airti me/a irtime-1+6. 1-GA.i 


tar. gz [following] 
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. d 1 .sourceforge + net/project/a i rt i me/a i r 


"time-1.6,l-Gfl,tar.gz 


Resolving suitch.dl.sour-cefor-ge.net... 


130.59.133.21, 2001:620:0:lb::21 




Connecting to switch.dl. sourcef orge.nef 


t 1130. 53. 138. 21 1:30... connected. 




HTTP request sent, awaiting response... 


. 200 OK 




Length: 180724646 (172M) [application/: 


t-gzip] 




Saving to: 'airtime-1.6.1-GA.tar.gz' 






21 [> 


] 4,355,434 


*26K/s eta 4m 53s | 



Unzip the file you have just downloaded to the installation directory /var/lib/airtime/ with the 
following command: 

$ sudo tar -xvzf airtime-1.6. 1-GA. tar.gz -C /var/lib/ 

Change the ownership of the installation directory to the root user so that it is more secure: 

$ sudo chown -R root. root /var/lib/airtime/ 

Configure Apache 

Check that the Apache web server modules that Airtime requires are enabled: 



$ sudo a2enmod php5 rewrite 

The server should respond: 

Module php5 already enabled 
Module rewrite already enabled 

Next, create the Airtime virtual host configuration file for Apache: 

$ sudo nano /etc/apache2/sites-available/airtime 

and enter the information below, substituting your system administrator's email address for 
admin@example.com. Make sure you set the DocumentRoot and Directory paths correctly. This 
should match the public sub-directory of the installation directory that you unzipped the Airtime 
tarball into. 

<VirtualHost *:80> 

ServerAdmin admin@example.com 
DocumentRoot /var/lib/airtime/public 

SetEnv APPLICATION_ENV "development" 

<Di rectory /var/lib/airtime/public> 

Directorylndex index. php 

AllowOverride all 

Order allow, deny 

Allow from all 
</Directory> 
</VirtualHost> 

Press Ctrl+O to save the file, then Ctrl+X to exit the nano editor. Then enter the command: 

$ sudo a2ensite airtime 

The server should respond: 

Enabling site airtime. 

Run Vetc/init.d/apache2 reload' to activate new configuration! 



As suggested by the output of the command above, reload the web server configuration. 
$ sudo /etc/init.d/apache2 reload 
The server should respond: 
* Reloading web server config apache2 

Enable Icecast 

Before you run the Icecast streaming media server for the first time, edit the file 
/etc/icecast2/icecast.xml to change the default <source-password>, <relay-password> and <admin- 
password> values from 'hackme' to something more secure. 



I GNU nano 2.2.2 File: /etc/icecast2/icecast.xrcl 1 


it also significantly increases latency between the source 




client and listening client.,. For low-latency setups, you 




might want to disable this. — > 




<bur-st-on-connect>K/burst-on-connect> 




<! — same as burst-on-connect, but this allows for being more 




specific on how much to burst + Most people won't need to 




change from the default G4k + Applies to all mountpoints — > 




<bur-st-size>G5535</burst-size> 




</limits> 




<authentication> 




<! — Sources log in with username 'source' — > 




<source-password>hackme& J, source-password> 




<! — Relays log in user-name ' relay' — > 




<re 1 ay-password>hackme</r-e 1 ay-password> 




<! — Admin logs in with the username giuen below — > 




<adm i n-user>adm i n<7adm i n~user> 




<adm i n-password>hackme</adm i n-password> 




</authentication> 




<! — set the mountpoint for a shoutcast source to use r the default if not 




specified is /stream but you can change it here if an alternative is 
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Then set up the Icecast server to start automatically: 

$ sudo nano /etc/default/icecast2 

by setting the value of ENABLE to true on the last line of this file: 

ENABLE=true 

Save and close the file with Ctrl+O and Ctrl+X, then start Icecast: 

$ sudo service icecast2 start 

The server should respond: 

Starting icecast2: Starting icecast2 
Detaching from the console 
icecast2. 

Set up and install Airtime 

In the Liquidsoap configuration file, set the value of icecast_pass to the <source-password> value that 
you set in the Icecast configuration file: 



sudo nano /var/lib/airtime/pypo/scripts/ls_config. liq 



GNU nano 2.2 + 2 



File; /yar/lib/airtine/pypo/scripts/ls_conf ig.liq 



# list pointing to the current couchcaster mountpoint 

"http://vdeb.openbroadcast.ch/nod/ivil/ 



########################################### 

# stream settings * 
########################################### 
icecast.host = "127.0.0.1" 
icecast_port = 8000 

icecast_pass = "hackmel 

tt mountpoints 

mount_point_mp3 = "airtime.mp3" 

mount_point_vorbis = "airtime. ogg" 

tt mount intra is used for scheduler >» fallback stream 
mount_intra = "pypo_intra" 

* intra-LS streaming (no icecast here) 
intna_host = "127.0.0.1" 
intr-a.por-t = 9000 



icecast_url = "http://airtime.soureefabric.org" 
icecast_description = "Airtime Radio!" 
icecast_genre = "genre" 

output _sound_dev ice = false 
output_icecast_vorbis = true 
output. icecast_mp3 = true 



You can also configure the values of mount_point_mp3, mount_point_vorbis, icecast_url, 
icecast_deschption, and icecast_genre to suit your station. 

If you require direct output to an ALSA soundcard device on the Airtime server, in addition to the 
Icecast stream, change the value of output_sound_device from the default of false to true-. 

output_sound_device = true 

If you do not require an Icecast stream in either OggVorbis or MP3 format, you can set the values of 
output_icecast_vorbis or output_icecast_mp3 respectively to false. 

Save and close the file with Ctrl+O and Ctrl+X, then enter the following commands to create the 
Airtime databases, tables, and directories: 

$ cd /var/lib/airtime/install/ 
$ sudo php airtime-install.php 

Finally, reboot your server so that daemontools can initialize correctly. 

Administration interface 

You can access the Airtime web interface by opening a web browser and entering the address: 



http://localhost/login 

You can login with the usemame "admin" and password "admin". 
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Done 



You should set a more secure administrator password immediately, using the Manage Users entry on 
the Configure menu. 




To check that the Icecast server is running, open port 8000 in your web browser: 

http://localhost:8000/ 

You should see the Icecast status page, with details of the connection that Airtime has made to 
Icecast. If you have only just installed Airtime, there won't be anything playingyet. 
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Made with Booki 

Visit http://software.booki.cc 



